# 案例：打开‘注册实例.html’页面（本地文件），完成以下操作
# 1). 填写主页面的注册信息（主文档中的表单）
# 2). 切换到注册页面A的frame框架，填写其注册信息
# 3). 切换回主文档，再切换到注册页面B的frame框架，填写其注册信息
# 核心：多frame页面操作的关键是「切换frame上下文」，否则无法定位框架内的元素

# 从time模块导入sleep函数，用于操作间隔暂停（等待页面加载、框架渲染）
from time import sleep
# 从selenium库导入webdriver模块，用于创建浏览器驱动、控制浏览器
from selenium import webdriver
# 导入ActionChains类（此处未实际使用，保留原导入，可后续扩展）
from selenium.webdriver import ActionChains
# 导入By类：适配新版selenium，替代已弃用的find_element_by_*方法
from selenium.webdriver.common.by import By
# 从selenium导入Keys类（此处未实际使用，保留原导入，可后续扩展）
from selenium.webdriver.common.keys import Keys
# 导入WebDriverWait类（此处未实际使用，保留原导入，可后续扩展显式等待）
from selenium.webdriver.support.wait import WebDriverWait

# 1. 初始化并打开Chrome浏览器
# executable_path：指定ChromeDriver驱动的本地绝对路径（适配selenium3及以下版本）
driver = webdriver.Chrome(executable_path='D:/chrome_driver/chromedriver.exe')
# 注释：selenium4及以上版本推荐写法（无需手动指定驱动路径）
# 需提前安装 webdriver-manager 库（pip install webdriver-manager），自动匹配浏览器版本下载驱动
# driver = webdriver.Chrome() # 创建Chrome浏览器对象，后续通过该对象执行所有操作

# 放大浏览器窗口
# maximize_window()：将窗口调整为屏幕最大尺寸，避免元素/框架因窗口过小被隐藏
driver.maximize_window()

# 2. 访问本地目标页面（注册实例.html）
# 定义本地文件路径：使用r前缀表示原始字符串，避免反斜杠被解析为转义字符
url = r"C:\Users\HP\Desktop\UI自动化测试\注册实例.html"
# get()方法：支持本地文件路径（直接传入绝对路径）或网络URL，此处加载本地HTML文件
driver.get(url)

# 暂停2秒：等待页面及框架完全加载（本地页面加载快，可适当缩短，确保框架渲染完成）
sleep(2)

# ---------------------- 1). 填写主页面的注册信息（主文档上下文） ----------------------
# 注意：此时未切换任何frame，操作的是主文档（<html>根节点）中的元素
# 定位主页面用户名输入框（id="user"），输入"admin"
# 修复：替换已弃用的find_element_by_css_selector→使用find_element(By.CSS_SELECTOR, 定位器)
driver.find_element(By.CSS_SELECTOR, "#user").send_keys("admin")

# 定位主页面密码输入框（id="password"），输入"123456"
driver.find_element(By.CSS_SELECTOR, "#password").send_keys("123456")

# 定位主页面电话号码输入框（id="tel"），输入"13012345678"
driver.find_element(By.CSS_SELECTOR, "#tel").send_keys("13012345678")

# 定位主页面电子邮件输入框（id="email"），输入"123@qq.com"
driver.find_element(By.CSS_SELECTOR, "#email").send_keys("123@qq.com")

# 暂停1秒：观察主页面输入效果，为切换frame做准备
sleep(1)

# ---------------------- 2). 填写注册页面A的注册信息（frame框架上下文） ----------------------
# 核心逻辑：frame框架是独立的文档，必须先切换到框架上下文，才能定位框架内的元素
# 步骤1：切换到注册页面A的frame框架
# 原代码尝试两种切换方式：name="myframe1" 或 id="idframe1"（需与页面实际frame属性一致）
# 关键：需确认页面中frame的name或id是否正确（如页面frame的id是"myframe1"，则需改为对应值）
# 推荐：优先使用id切换（唯一性强），此处假设页面frame的id为"idframe1"，若实际为其他值需修改
driver.switch_to.frame("idframe1")  # 通过frame的id切换（推荐）
# 若frame无id但有name，可使用name切换：driver.switch_to.frame("myframe1")
# 若frame无id/name，可通过索引切换（如第一个frame索引为0）：driver.switch_to.frame(0)

# 步骤2：填写注册页面A的表单（此时上下文在frame内，定位的是frame中的元素）
# 用户名（id="userA"），输入"1111"
driver.find_element(By.CSS_SELECTOR, "#userA").send_keys("1111")

# 密码（id="passwordA"），输入"123456"
driver.find_element(By.CSS_SELECTOR, "#passwordA").send_keys("123456")

# 电话号码（id="telA"），输入"13012345678"
driver.find_element(By.CSS_SELECTOR, "#telA").send_keys("13012345678")

# 电子邮件（id="emailA"），输入"123@qq.com"
driver.find_element(By.CSS_SELECTOR, "#emailA").send_keys("123@qq.com")

# 暂停1秒：观察注册A页面输入效果
sleep(1)

# ---------------------- 3). 填写注册页面B的注册信息（切换frame上下文） ----------------------
# 步骤1：从注册A的frame切换回主文档（必须先返回主文档，才能切换到其他frame）
# switch_to.default_content()：恢复到主文档上下文（根节点），退出所有frame
driver.switch_to.default_content()

# 步骤2：切换到注册页面B的frame框架（假设frame的name为"myframe2"，需与页面实际一致）
driver.switch_to.frame("myframe2")  # 通过frame的name切换

# 步骤3：填写注册页面B的表单（上下文在注册B的frame内）
# 用户名（id="userB"），输入"1111"
driver.find_element(By.CSS_SELECTOR, "#userB").send_keys("1111")

# 密码（id="passwordB"），输入"123456"
driver.find_element(By.CSS_SELECTOR, "#passwordB").send_keys("123456")

# 电话号码（id="telB"），输入"13012345678"
driver.find_element(By.CSS_SELECTOR, "#telB").send_keys("13012345678")

# 电子邮件（id="emailB"），输入"123@qq.com"
driver.find_element(By.CSS_SELECTOR, "#emailB").send_keys("123@qq.com")

# （可选）延长暂停时间观察最终效果，然后关闭浏览器
sleep(3)
# 关闭浏览器并释放资源
driver.quit()